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This  document  describes  the  Computer  Generated  Acquisition 
Documents  System  (CGADS) . 

1-0  System  Description 

CGADS  is  a  computer  based  system  designed  to  automate  the 
generation  of  Air  Force  acquisition  documents  and  is  intended  to 
standardize  their  contents. 

The  system  has  two  modes  of  operation,  file  creation  and  update, 
and  document  production. 

In  the  file  creation  and  update  mode,  information  relative  to  an 
acquisition  document  is  interactively  entered  into  the  system  and  stored 
on  a  series  of  interrelated  files.  The  information  entered  is  the 
information  which  will  be  used  to  produce  a  document. 

The  system  guides  the  data  entry  process  by  displaying  a  series  of 
menus  which  offer  the  operator  a  number  of  options  in  selecting  a 
function  to  be  performed.  After  a  function  has  been  selected,  a  more 
detailed  level  of  guidance  is  offered  in  the  form  of  a  purposefully 
ordered  arrangement  of  questions,  the  answers  tc  which  prompt  the  system 
to  accept  the  information  which  updates  its  files.  In  this  way  the 
system  provides  on-line  update  capability  to  the  data  bases  which  are 
used  to  store  the  information  which  ultimately  produces  a  document. 

The  document  production  mode  is  also  an  interactive  process.  In 
it,  a  user  interactively  interfaces  with  the  system  to  produce  a 
document.  A  user  is  asked  to  enter  the  system  by  establishing  an 
identity  and  by  designating  a  document  to  be  produced.  As  in  the  update 
mode,  the  system  guides  the  user  in  developing  a  document  by  displaying 
a  series  of  menus  from  which  an  option  is  selected.  The  user  is  then 
offered  the  opportunity  to  complete  a  series  of  tasks,  i.e.,  to  respond 
to  a  series  of  functionally  related  questions,  within  a  user  selected 
functional  area.  The  user's  responses  to  the  questions  enable  the 
system  to  retrieve  the  appropriate  information  from  its  data  bases  to 
produce  a  document . 
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2.0  Definitions 

PRODUCT 

DRAFT  PRODUCT 


AREA 


TASK 


a  computer  generated  acquisition  document. 

a  product  generated  by  the  system  is  referred 
to  as  a  draft  product  when  some  of  the 
information  required  to  produce  the  finished 
product  is  not  available  from  the  system's 
data  bases.  In  those  cases  a  message  stating 
that  tailoring  is  required  by  the  Program 
Office  will  be  substituted.  As  time  goes  on 
it  is  intended  that  most  if  not  all  of  the 
data  to  complete  a  product  will  be  maintained 
by  the  CGAD  System. 

an  area  refers  to  a  grouping  of  related  tasks. 
In  developing  a  product  certain  functional 
areas  need  to  be  addressed.  For  example,  the 
areas  of  engineering,  configuration  and  data, 
program  management,  logistics,  packaging  and 
transportation  are  addressed  to  complete  a 
Statement  of  Work  for  the  Production  Phase . 

The  tasks  to  be  performed  in  generating  a 
product  are  grouped  within  these  areas. 

a  task  refers  to  a  group  of  functionally 
related  questions.  For  example,  the  task. 
Logistics  Support  Analysis  (LSA)  in  the  area 
of  Preoperational  Maintenance  generates  the 
question,  "Has  LSA  been  developed  previously 
during  the  validation  and  full  scale 
development  phases?".  The  system  provides  a 
basic  outline  of  an  acquisition  document.  By 
answering  the  questions,  the  user  specifies 
what  data  is  to  be  included  in  the  product. 


Tf.e  answers  enable  the  system  to  retrieve 
information  from  its  data  bases  to  complete 
the  outline. 

QUESTIONS  questions  refer  to  that  part  of  the  system 

which  elicits  responses  or  input  from  the  user 
in  order  to  ascertain  or  determine  what 
information  will  be  output  as  part  of  a 
product.  Answering  questions  is  the  work  the 
user  does  to  complete  a  task,  i.e.  part  of  a 
document.  The  system  prompts  the  user  with 
questions.  The  user's  answers  permit  the 
production  of  information  from  the  system  to 
develop  the  sections,  paragraphs,  and  text 
that  go  into  a  document. 

NOTES  TO  TERMINAL  messages  output  to  the  terminal  after  a 

question  has  been  answered,  which  provide 
information  to  suggest  that  the  question  may 
have  been  answered  incorrectly. 

DOCUMENTS  mil  standards,  mil  specs,  mil  handbooks, 

technical  manuals  and  other  regulatory  or 
reference  material  used  in  the  product. 

HEADERS  document  references  and  titles  to  be  included 

in  a  product. 

PARTS  parts  refer  to  the  section  numbers,  paragraph 

numbers,  appendices,  etc.  of  a  document 
(document  parts)  which  are  to  be  included  as 
part  of  a  product. 

ESSENTIAL  ENTRIES  entries  vdiich  must  be  included  as  part  of  a 

product . 
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OPR 

LIBRARY 


office  of  Primary  Responsibility  for  a  task. 


refers  to  a  group  of  data  stored  on  the 
system's  data  bases  and  organized  in  linked 
lists . 


I 
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3.0  File  Descriptions 

File  Names; 

DOCFILE 

USERS 

TSKnn 

INDnn 

STRnn 

EiEADERS 

STDFILE 

PRINTOUT 

WPnnn 

3.1  DOCFILE 

File  type;  direct  access 
Record  length;  256  characters 

The  DOCFILE  contains  product  titles  and  pointers  to  related 
information.  It  has  99  records  to  accommodate  up  to  99  products. 
Record  number  100  is  used  to  store  a  count  of  the  number  of 
products  currently  in  the  system. 

3.1.1  Records  1  to  99  (nn  represents  record  number) 


position 


description 


1-70 


the  product  title . 


71-78  a  pointer  to  the  product  OPR  in  the  STRnn  file. 

The  value  of  the  pointer  is  the  number  of  the 
record  pointed  to  in  the  STRnn  file. 
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79-86 


87-94 


95-102 


103-110 


111-118 


119-126 


a  fxjinter  to  a  record  in  the  TSKnn  file  which  has 
pointers  to  the  product's  first  task.  The  value 
of  the  pointer  is  the  number  of  the  record  pointed 
to  in  the  TSKnn  file. 

a  pointer  to  the  last  record  in  the  TSKnn  file. 

The  value  of  the  pointer  is  the  number  of  the 

record  pointed  to  in  the  TSKnn  file.  It  is  also  a 
count  of  the  number  of  records  in  the  TSKnn  file. 

a  pointer  to  the  last  record  in  the  STRnn  file. 

The  value  of  the  pointer  is  the  number  of  the 

record  pointed  to  in  the  STRnn  file.  It  is  also  a 
count  of  the  number  of  records  in  the  STRnn  file. 

a  pointer  to  the  last  record  in  the  INDnn  file. 

The  value  of  the  pointer  is  the  number  of  the 

record  pointed  to  in  the  INDnn  file.  It  is  also  a 
count  of  the  number  of  records  in  the  INDnn  file. 

a  count  of  the  total  number  of  questions  that  have 
been  input  for  the  product.  Deletions  are  also  a 
part  of  the  total.  Used  to  determine  the  number 
of  records  that  are  allocated  in  the  USERS  file  to 
store  answers  to  the  questions. 

a  date.  The  date  of  the  last  modification  to  a 
product  task. 
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example ; 


1 

I 

Statement  of  Work  for  the  Conceptual  Phase 


71 

1 

78 

I 

79 

1 

86 

1 

87 

1 

94 

1 

95 

1 

102 

1 

1 

1 

1179 

1 

1 

24 

1 

1 

29 

1 

1 

1181 

118  119  126 

!  I  I 

80  12/03/81 

3.1.2  Record  number  100 


70 


103  110 

I  1 

862 


position  description 

1-8  a  count  of  the  number  of  products  currently  in  the  system. 


9-16  a  pointer  to  the  last  record  of  the  last  entry  in  the 

HEADERS  file.  The  value  of  the  pointer  is  the  number  of  the 
record  pointed  to  in  the  HEADERS  file. 


example ; 

8  16 

I  I 

6  1760 


3.1.3  Data  Structures 


Proqram  references: 

records  1  to  99 

position 

item  name 

Fortran  format 

1-70 

TTL 

A70 

71-78 

DOC_OPR 

18 

79-86 

FST_TSK 

18 

87-94 

LST_TSK 

18 

95-102 

LST_STR 

18 

103-110 

LST_STR_IND 

18 

111-118 

LST-ANS 

18 

119-126 

DAT 

A8 

Proqram  references; 

record  100 

position 

item  name 

Fortran  format 

CO 

LST_D0C 

18 

9-16 

LST-HDR 

18 

i.2  USh'RS 


Kile  type:  ilirect  n-eess 
Rfic'or  l  lenqth:  IfiO  eh.ir  icters 

This  file  is  used  to  store  i nfonn  it  ion  ibout  users  of  the 
system.  The  file  contains  three  record  type's.  Tliere  is  one  to 
one  ru'l  itionship  between  i  USER'S  fib?  r-rcor  !  md  i  prcxiuct  beinq 
worked  on. 

3.2.1  Reu-or  1  1 


nos i t ion 

1-a 


9-16 


exarnn  1 


'lescr  1  pt  ion 


a  count  of  the  total  nuinber  of  users  in  the 
system,  i.e.  th-.'  usu'r  number  issiqned  to  the 
Inst  user  ent...-red  u.  the  sy‘it.<_tn. 


the  record  number  of  th.e  1  nst  record 
issiqned  to  n  user  in  the  USERS  files 
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3.2.2  Records  2  TO  201 


position 

1-40 


description 

user  information  -  name,  office,  phone 
number . 


41-70 

71-78 


79-86 


87-89 


90-92 


user's  program  name. 

a  date  -  the  date  the  user  entered  the  user 
record  into  the  system. 

a  pointer  to  a  record  in  the  USERS  file 
where  the  answers  (to  system  questions) 
entered  by  a  particular  user  begin.  The 
value  of  the  pointer  is  the  record  number  of 
the  first  record  in  the  USERS  file  where 
that  user's  answers  are  stored. 

the  number  of  records  allocated  for  a  user's 
answers  to  questions  for  a  related  product. 

the  identification  number  of  the  product 
being  worked  on  by  a  user.  This  number  also 
serves  as  a  pointer  to  the  DOCFILE  record 
which  contains  the  product  title  and  related 
information.  The  value  of  the  pointer  is 
the  number  of  the  record  pointed  to  in  the 
DOCFILE. 
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example ; 


1 

1 

40  41 

1  1 

I 

SKIP  ROEDER 

TOH 

1  1 

2926  IMPACT 

71  78  79 

1  1  1 

86 

1 

89 

1 

92 

1 

i  i  t 

11/23/81 

1 

203 

1 

2 

1 

1 

3.2.3  Record  s  202 

to  end 

This  record  contains  an  array 

of  one  hundred 

1  character 

fields  which  store 

the  Y,  N, 

or  U 

answers  to  the 

system 

questions . 

3.2.4  Data  Structures 

Program  references 

:  record  1 

position 

item  name 

Fortran 

format 

1-8 

LST_USR 

18 

9-16 

LST_USR_ 

_REC 

18 

Program  references 

records 

2  to 

201 

position 

item  name 

Fortran 

format 

1-70 

71-78 

79-86 

87-89 

90-92 


USR_INF 

A70 

USR_DAT 

A8 

USR_ANS 

18 

USR_REC 

13 

DOC 

13 

Fortran  format 


r 


Program  references;  REC_NBR 


position 


item  name 


100 


ANS  REC 


AlOO 


13 


3 . 3  TSKnn 


File  type:  direct  access 
Record  length:  64  Characters 

The  system  creates  one  TSKnn  file  for  each  product,  where  nn 
equals  the  product  number  assigned  to  the  product  by  the  system. 
For  example,  the  TSKnn  file  for  product  1,  Statement  of  Work  for 
the  Conceptual  Phase,  is  TSKOl. 

The  TSKnn  files  contain  information  and  pointers  to  the 
different  tasks  which  are  to  be  ccrapleted  within  a  given  area  for 
a  product . 


Tasks  are  in  the  form  of  questions  to  be  answered  by  the  user 
after  an  area  has  been  selected.  Tasks  are  broken  down  into 
areas  of  work  to  be  completed  for  each  product,  such  as,  for 
product  1,  the  areas  are:  1-Engineering,  2-Configuration, 
3-Program  Management,  4-Logistics,  5-Packaging  and 
Transportation . 


position 


1-8 


9-16 


description 

a  pointer  to  the  task  title  in  the  STRnn 
file.  The  value  of  the  pointer  is  the 
record  number  of  the  STRnn  file  containing 
the  task  title . 

the  task's  area  number 


17-24 


the  task  number  within  the  area. 


25-32  a  pointer  to  the  OPR  information  in  the 

HEADERS  file.  The  value  of  the  pointer  is 
the  number  of  the  record  pointed  to  in  the 
HEADERS  file. 
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33-40 


41-48 


a  pointer  to  a  record  in  the  INDnn  file 
which  contains  a  pointer  to  a  record  in  the 
STRnn  file  which  contains  the  first  question 
to  be  answered  for  a  selected  task .  The 
value  of  the  pointer  is  the  number  of  the 
record  pointed  to  in  the  INDnn  file. 

a  pointer  to  the  next  task  in  the  TSKnn 
file.  The  value  of  the  pointer  is  the 
number  of  the  record  in  the  TSKnn  file  of 
the  next  task  to  be  performed.  If  zero, 
there  are  no  more  tasks . 


49-56 


a  date .  The  date  on  which  the  task  was  last 
modified . 


example; 


8  9  16  17  24  25  32  33  40  41  48  49 


56 


61 


17  10/08/81 


1 


IL 


3.4  INDnn 


File  type:  direct  access 
Record  length:  20  characters 

The  system  creates  one  INDnn  file  for  each  product,  where  nn 
equals  the  product  number  assigned  to  the  product  by  the  system. 

The  INDnn  files  contain  pointers  to  the  questions  located  in 
the  STRnn  files  and  indicate  a  series  of  actions  to  be  taken 
depending  on  the  answers  to  the  questions. 

The  file  contains  several  record  types.  A  record  is 
identified  by  a  unique  character  in  position  1.  The  record  types 
are:  1,  A,  2,  3,  4,  5,  6,  7,  M,  S,  H,  O,  and  P. 


3.4.1  Record  Types 

3 . 4 . 1 . 1  Record  type  " 1 " 


position 

1 


position 


2-9 


10-17 


description 

value  equals  1.  Indicates  that  this  record 
points  to  a  question. 

description 

a  pointer  to  a  question  in  the  STRnn  file. 
The  value  of  the  pointer  is  the  number  of 
the  first  of  a  series  of  records  in  the 
STRnn  file  which  contain  a  question. 

A  pointer  to  the  next  record  in  the  INDnn 
file  which  contains  a  pointer  to  the  next 
question  in  the  same  task.  The  value  of  the 
pointer  is  the  number  of  the  record  pointed 
to  in  the  INDnn  file.  If  the  pointer  equals 
0,  there  are  no  more  questions  in  this  task. 


17 


1 

1 

1 


2  9 

I  I 

56 


10  17 

I  1 

31 


3. 4. 1.2  Record  type  “A" 


position 


description 


1 


value  equals  A.  Indicates  that  this  record 
contains  answer  information. 


2-9  a  pointer  to  a  position  in  an  entry  in  the 

USERS  file  which  stores  answers  to  the 
questions.  The  value  of  the  pointer  is  a 
position  in  an  array  of  answers. 


10-17  unused. 

example; 


9 


17 


1 

I 

A 


2 


1 


10 


0 


18 


3.4. 1.3  Record  types  "2",  ‘'3",  and  "4‘ 


jsition 


description 


example; 


value  equals  2,  3  or  4.  Indicates  that  this 
record  contains  information  for  an 
answer — Y,  N,  or  U  respectively. 


10-17 


this  item  tells  the  program  where  to  go  next 
in  a  sequence  of  questions,  referred  to  as  a 
task.  If  the  value  is  positive  it  indicates 
that  a  number  of  questions  are  to  be 
skipped  in  the  task.  The  value  specifies 
the  number  of  questions  to  be  skipped.  If 
the  value  is  0,  no  questions  are  skipped?  if 
-1,  the  program  does  not  go  on  to  another 
question,  but  exits  the  task. 

a  pointer  to  a  record  in  the  INDnn  file 
which  contains  a  pointer  to  the  first  string 
of  information  for  an  answer.  The  value  of 
the  pointer  is  the  number  of  the  record 
pointed  to  in  the  INDnn  file.  If  the 
pointer  equals  0,  it  means  that  the  system 
has  no  more  information  to  output  in 
response  to  the  answer  given. 


1  2 
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3. 4. 1.4  Record  types  "5",  ‘'6",  and  "7" 

description 


position 

1 


value  equals  5,  6,  or  7.  Indicates  that 
this  record  points  to  an  essential  entry,  an 
action  message,  or  notes  to  terminal 
respectively. 


2-9 


a  pointer  to  the  essential  entry,  action 
message,  or  notes  to  terminal  in  the  STRnn 
file.  The  value  of  the  pointer  is  the 
number  of  the  record  pointed  to  in  the  STRnn 
file. 


10-17 


a  pointer  to  the  next  record  in  the  INDnn 
file  which  contains  a  pointer  to  the  next 
string  of  information  generated  by  a 
particular  answer.  The  value  of  the  pointer 
is  the  number  of  the  record  pointed  to  in 
the  INDnn  file.  If  the  pointer  equals  0, 
there  is  no  more  information. 


example ; 


5 

6 
7 


9 

1 

10 

1 

17 

1 

1 

48 

1 

1 

96 

185 

84 

250 

0 

( 


3.4. 1.5  Record  types  "M" .  "S",  "H",  and  "O 


3sition 


description 


examples 


value  equals  M,  S,  H,  or  O.  Indicates  that 
this  record  points  to  a  mil  standard,  a  mil 
spec,  a  mil  handbook,  or  other  documents 
respectively. 

a  pointer  to  the  header  records  for  a  mil 
standard,  mil  spec,  mil  handbook,  or  other 
documents  in  the  HEADEI^S  file.  The  value  of 
the  pointer  is  the  number  of  the  record 
pointed  to  in  the  HEADERS  file. 


10-17 


same  as  the  item  in  positions  10-17  of  the 
record  type  described  in  paragraph  3. 4. 1.4. 
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3.4. 1.6  Record  type  "P" 


position 

1 


2-9 


10-17 


example; 

1 


description 

value  equals  P.  Indi^  ites  that  this  record 
points  to  a  document  part. 

a  pointer  to  a  record  in  the  STDFILE 
containing  a  document  part.  The  value  of 
the  pointer  is  the  number  of  the  record 
pointed  to  in  the  STDFILE. 

same  as  the  item  in  positions  10-17  of  the 
record  type  described  in  paragraph  3. 4. 1.4. 


9  10  17 

I 

156 


P 


2 


78 
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3.4.2  Data  Structures 

Program  references 

;  NXT,  LST_STR_IND 

(DOC),  LST,  B£CJ 

NXT_QUS(A) . 

position 

item  name 

Fortran  format 

1 

TYP 

A1 

1 

ANS 

A1 

2-9 

ADD 

18 

2-9 

QUS_SKP 

18 

10-17 

NXT_IND 

18 

10-17 

NXT_QUS 

18 

10-17 

NXT 

18 

10-17 

NXT_SAV 

18 

Program  reference; 

QUS_ADEH-1 

position 

item  name 

Fortran  format 

1 

TYP 

A1 

2-9 

ANS-ADD 

18 
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3.5  STRnn 

File  type:  direct  access 
Record  length:  71  characters 

The  system  creates  one  STRnn  file  for  each  product,  where  nn 
equals  the  product  number  assigned  to  the  product  by  the  system. 

The  STRnn  file  records  contain  strings  of  text  which  are  to 
be  included  in  the  draft  product  such  as  tasks,  titles, 
questions,  cautions,  essential  entries,  action  messages,  and 
notes  to  the  terminal.  The  STRnn  files  also  contain  product  OPR 
information . 

position  description 

1-70  a  string  of  text  as  described  above.  An 

entry  may  require  one  or  more  records  to 
complete  a  string  of  text.  The  last  record 
of  an  entry  contains  in  record  position 

71  to  signify  the  last  record  of  the  string. 


71  value  is  blank  or  . 

exeimple : 

1  70  71 

I  II 

SOW;  CXXDRDINATE  WITH  SYSTEM  ENGINEERING  AND  HAVE  THE  FINDINGS  OF  LSA 
BE  AN  INTEGRAL  PART  OF  THE  TECHNICAL  REVIEWS.  INSURE  THAT  LSA 
IS  AN  AGENDA  ITEM  ON  TECHNICAL  REVIEWS. 

CDRL:  DATA  IS  STILL  TO  BE  GENERATED,  REVISED,  AND  ACTED  UPON  DUE  TO 

DESIGN  CHANGES.  DI-L-30316  APPLIES.  ~ 
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3.5.1  Data  Structure 
Program  reference;  REC_NUM 

position  item  name  Fortran  format 

1-70  STR  A70 

71  A1 


Program  reference"  REC_NUM,  REC_NBR,  TSK_TTL 


position 


item  name 


Fortran  format 


1-71 

STR 

1-71 

STR 

(MAX_LIN) 

1-71 

STR 

(ILIN) 
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3.6  HEADERS 


File  type:  direct  access 
Record  length;  73  characters 

The  HEADERS  file  contains  five  types  of  headers  to  be 
included  in  the  draft  product.  They  are  document  headers  and  OPR 
information.  The  document  headers  are  either  mil  standards,  mil 
specs,  mil  handbooks,  or  other  documents.  The  header  records  are 
located  via  a  pointer  in  the  TSKnn  file. 

position  description 

1-73  text  containing  the  header  information,  as 

described  above.  Twenty  records  are 
reserved  for  each  entry,  whether  or  not  they 
are  used.  The  end  of  text  is  indicated  by 
"r->"  in  position  73  of  the  last  record  of 
the  entry. 

examples; 

a  document  header: 

1  73 


MIL-STD-1528  Production  Management 

1  Aug  72 


an  OPR  header: 


1  73 

I  I 

IGERALD  ZAHN  ESD/TOMM  HANSCOM  AFB  X  13593 


AV-478-4903 
(617) -861-4903 


3.7  STDFILE 


File  type:  direct  access 
Record  length:  32  characters 

The  STDFILE  file  contains  pointers  to  document  header  records 
in  the  HEADERS  file,  and  pointers  to  document  parts  contained 
within  the  STDFILE. 

A  record  type  is  identified  by  a  unique  character  in  record 
position  1  which  represents  the  type  of  data  the  record  points 
to.  The  record  identifiers  are: 

M  -  mil  standard  headers 
S  -  mil  spec  headers 
H  -  mil  handbook  headers 
O  -  other  document  headers 
R  -  OPR  information 
Y  -  not  used 
P  -  document  parts 

The  identifier  identifies  a  record  which  points  to  a  record 
which  is  a  member  in  a  library  of  data.  A  library  of  data  is  a 
group  of  data  organized  in  a  linked  list.  One  of  the  lists  (the 
parts  library)  is  on  the  STDFILE.  The  others  are  on  the  HEADERS 
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3.7.1  Record  numbers  1  to  7 


The  first  seven  records  of  the  file  contain  pointers  to  the 
first  record  in  the  STDFILE  which  points  to  a  library. 


position 


description 


i 


2-9 


10-17 


value  is  M,  S,  H,  O,  R,  Y,  or  P.  An 
identifier  which  indicates  the  record  type. 

a  pointer  to  the  first  record  of  the 
identifier  type  in  the  STDFILE.  The  value 
of  the  pointer  is  the  number  of  the  record 
pointed  to  in  the  STDFILE. 

Same  as  above . 


example ; 

12  9  .10  17 

III  I  i 

M  189  189 

3.7.2  Record  number  8 

This  record  maintains  a  count  of  the  number  of  records  in 
the  file.  It  is  identified  by  an  "F"  in  record  position  1. 


position 


description 


1 


value  is  F. 


2-9 


a  count  of  the  number  of  records  in  the 
STDFILE  file. 


10-17 


same  as  above 
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3.7.3  Record  types  "M",  "S",  "H",  “O",  "R",  and  "Y" 


position 

1 


2-9 


10-17 


18-25 


description 

value  is  M,  S,  H,  O,  R,  or  Y.  An  identifier 
which  indicates  the  type  of  header  pointed 
to. 


a  pointer  to  the  identified  header  in  the 
HEADERS  file.  The  value  of  the  pointer  is 
the  number  of  the  record  pointed  to  in  the 
HEADERS  file. 

a  pointer  to  the  next  record  of  the  same 
type  in  the  STDFILE.  The  value  of  the 
pointer  is  the  number  of  the  record  pointed 
to  in  the  STDFILE. 

a  key/unique  identifier  which  allows  the 
system  to  directly  locate  an  entry  in  the 
HEADERS  file.  For  M,  S,  H,  or  O  type 
records  this  identifier  is  extracted  from 
the  document  header.  For  example,  MIL  STD 
1552  would  be  assigned  the  va’ue  1552.00  as 
an  entry  identifer.  For  O  type  records 
(other  documents)  some  of  which  do  not  have 
an  identifying  number,  a  number  is  assigned. 
For  R  type  records  (OPR  lieaders)  the 
identifer  represents  the  area  and  task 
number  to  which  it  applies.  For  example. 
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1.13  means  area  1,  task  13. 


example: 


10  17 


18  25 


3.7.4  Record  Type  "P' 


1521.00 


>sition 


description 


value  is  P.  Identifies  a  document  parts 
pointer. 

a  pointer  to  a  document  parts  record.  The 
value  of  the  pointer  is  the  record  number  of 
the  STDFILE  which  contains  the  documement 


10-17 


a  pointer  to  the  next  "P"  record.  The  value 
of  the  pointer  is  the  record  number  of  the 
STDFILE  which  contains  the  next  "P"  record. 


example: 


10  17 


3.7.5  Document  part  record 


ssition 


description 


this  item  contains  the  text  referred  to  as  a 
document  part. 


3.8  PRINTOUT 


File  type:  sequential 
Record  length:  81  characters 

The  PRINTOUT  file  contains  output  from  the  CREATE  program 
with  Fortran  carriage  controls  which  is  to  be  output  to  the 
printer.  It  is  used  in  the  file  creation  and  update  progam  only. 


3.9  WPnrm 


File  type:  sequential 
Record  length:  71  characters 

The  system  creates  one  WPnnn  file  for  each  user,  where  nnn 
equals  the  user  nundser  assigned  to  the  user  by  the  system. 

The  WPnnn  files  are  used  by  the  document  production  program 
to  store  information  which  is  to  be  output  to  the  printer. 


4.0  System  Modules 


CGADS  has  two  modules;  the  programs  CREATE  and  AUTO.  They 
are  stored  on  the  files  CREATE,  AUTO.  SYSSUB,  CRESUB  and  AUTSUB. 
The  files  are  described  below,  in  sections  4-1  through  4-5, 
respectively. 

4 . 1  CREATE 

This  file  contains  the  program  CREATE  which  creates  and 
updates  the  CGADS  data  base  files.  The  files  are  created  and 
updated  on-line  interactively  via  the  CREATE  program.  Data  is 
entered  in  response  to  a  series  of  questions  from  the  progreun. 

Prograun  CREATE  calls  on  subroutines  and  functions  which 
reside  in  the  files  SYSSUB  and  CRESUB.  SYSSUB  and  CRESUB  are 
described  in  subsections  4.3  and  4.4,  respectively. 

4.1.1  Input/Output  Files 

Seven  files  are  used  by  the  program.  They  are  both  created 
and  updated  by  the  program  CREATE.  Subsequent  to  creation, 
information  relative  to  an  acquisition  document  is  entered  into 
the  system  and  stored  on  these  files. 

The  files  are  described  in  section  3.0;  they  are  listed 
below; 

DOCFILE 

TSKnn 

INDnn 

STRnn 

STDFILE 

HEADERS 

USERS 


In  addition,  an  eighth  output  file  named  PRINTOUT  is 
produced.  Formatted  output  is  stored  on  it.  This  output  can 
consist  of  a  listing  of  document  headers,  a  listing  of  document 
parts,  euid/or  a  task  description. 

4.1.2  Ccmpilation,  Loading  and  Execution 

Compilation,  loading  and  execution  is  accomplished  by 
including  the  files  CREATE,  SYSSIB  and  CRESUB  in  the  load  stream, 
together  with  system  libraries  as  needed. 

As  of  this  writing,  the  load  stream  is  in  the  file  C. CREATE 
which  contains: 

F77  CREATE 
SEG 

VL  #CREATE 

LO  B_CREATE 

LO  B_CRESUB 

LI  VAPPLB 

LI 

SA 

QU 

CO-TTY 

The  command  "SEG  #CREATE"  will  execute  the  program. 

4.1.3  User  Input 

In  order  to  place  data  in  the  files,  CREATE  requires  input 
from  a  user.  The  user  must  execute  CREATE  and  then  follow 
the  instructions  which  are  displayed  by  the  program.  Data  thus 
entered  updates  the  CGADS  files.  If  desired,  the  user  can  obtain 
a  printout  of  the  results  of  the  interactive  session. 


36 


4.1.4  CREATE  Overview 

Program  CREATE  begins  with  the  screen  presentation  of  a 
"product"  menu.  A  product  must  be  selected  or  added.  If  the 
select  option  is  chosen,  a  list  of  current  products  (from  file 
DOCFILE)  is  printed  and  a  product  must  be  chosen  by  entering  its 
product  number. 

If  the  add  option  is  chosen,  the  title  of  the  new  product 
must  be  entered  and  the  system  assigns  a  product  number  to  it. 

The  title  is  stored  in  file  DOCFILE. 

CREATE  then  returns  the  product  menu  to  the  screen.  Several 
choices  are  available:  to  modify  the  product  title  or  OPR;  to 
examine  and  select  from  the  document  header  library  or  from  the 
document  part  library;  to  print  a  product  description;  to  delete 
users;  to  quit;  to  access  the  task  menu. 

Of  the  foregoing  choices,  only  one  permits  entry  of  task 
data:  accessing  the  task  menu.  The  task  menu  presents  several 
options .  The  important  options  in  terms  of  data  entry  are  to  add 
a  task  and  to  modify  a  task. 

In  order  to  add  or  to  modify  a  task,  the  area  number  and  the 
task  number  must  be  entered.  A  search  of  the  file  TSKnn  for  the 
area  and  task  number  is  made . 

If  a  task  is  to  be  added,  the  search  must  ascertain  that  a 
record  with  the  area  and  task  numbers  to  be  added  does  not  exist 
in  the  TSKnn  file.  The  user  is  then  instructed  to  enter  the 
task  title;  the  title  is  stored  in  the  STRnn  file.  A  new  record 
is  written  in  the  TSKnn  file,  and  TSKnn  pointers  are  updated  as 
appropriate.  Then  a  selection  to  "modify"  (in  this  instance,  to 
supply  data  where  none  existed)  that  particular  task  must  be 
made . 
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Adding  and  modifying  now  follow  the  same  program  sequence.  A 
search  of  TSKnn  for  a  record  with  the  area  and  task  numbers  is 
made.  The  title  of  the  task  is  printed  on  the  screen  from  the 
STRnn  file;  the  OPR  information,  from  the  HEADERS  file.  The 
title  may  be  changed;  the  OPR  may  be  changed,  or  added  if 
non-existent . 

Then  questions  may  be  inserted,  deleted,  or  edited.  The 
STRnn  file,  where  questions  are  stored,  and  the  INDnn  file,  where 
the  pointer  to  STRnn  is  kept,  are  updated  accordingly. 

In  addition,  the  sequence  of  actions  determined  by  each 
possible  response  (yes,  no,  or  undecided)  to  each  task  question 
may  be  modified.  The  sequence  is  controlled  by  chaining  pointers 
in  the  INDnn  file;  changes  in  the  sequence  are  reflected  in 
changes  in  the  INDnn  file. 

At  the  close  of  an  update  session,  the  user  may  obtain  a 
printout  of  the  task  description(s)  which  were  updated  during  the 
session. 

4.2  AUTO 


This  file  contains  the  program  AUTO  which  produces  a  computer 
generated  acquisition  document.  The  program  uses  a  series  of 
interrelated  data  files  as  a  data  base.  Information  from  the 
data  base  is  input  to  the  program  in  the  process  of  producing  a 
product . 

Program  AUTO  calls  on  subroutines  and  functions  which  reside 
in  the  files  SYSSUB  and  AUTSUB.  SYSSUB  and  AUTSUB  are  described 
in  subsections  4.3  and  4.5,  respectively. 


4.2.1  Input  Files 


Seven  files  are  used  for  input.  They  comprise  the  data  base, 
and  are  created  in  program  CREATE.  They  are  listed  below,  and 
are  described  in  section  3.0: 

USERS 

DOCFILE 

TSKnn 

INDnn 

STRnn 

HEADERS 

STDFILE 


4.2.2  Output  Files 

Information  for  the  output  is  collected  and  stored  on  a 
temporary  scratch  file  called  SCRnnn,  where  nnn  corresponds  to 
the  users  number.  The  user  identification  number  is  assigned  by 
the  system,  and  is  used  to  identify  a  user's  logical  record, 
i.e.,  the  user's  piece  of  work.  When  required  for  the  output, 
the  appropriate  information  is  read  from  SCRnnn  and  writt-in  to 
file  WPnnn,  which  stores  the  formatted  output  of  the  product. 


1 

t 

t 


1 

i 


J 
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4.2.3  Compilation  Loading  and  Execution 

Ccxnpilation,  loading  and  execution  is  accomplished  by 
including  the  files  AUTO,  SYSSUB  and  AUTSUB  in  the  load  stream, 
together  with  system  libraries  as  needed. 

As  of  this  writing,  the  load  stream  is  in  the  file  C.AUTO 
which  contains: 

F77  AUTO 
SEG 

VL  #CGADS 
LO  B_AUTO 
LO  B_SYSSUB 
LO  B_AUTSUB 
LI  VAPPLB 
LI 
SA 
QU 

CO  -TTY 

The  coTOiand  "SEG  tCGADS"  will  execute  the  program. 

4.2.4  User  Input 

In  order  to  produce  an  acquisition  document,  AUTO  requires 
input  from  a  user.  The  user  must  execute  the  program  and  then 
follow  the  instructions  displayed  by  the  program.  If  properly 
executed,  this  procedure  results  in  a  printout  of  the  generated 
product.  The  printout  is  either  an  acquisition  document  or  a 
draft  of  an  acquisition  document. 
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4.2.5  AUTO  Overview 


Once  the  user  begins  the  program,  initial  information  is 
displayed  cm  the  terminal  screen.  The  user  then  cam  initiate  an 
identifying  action  whereby  the  system  will  assign  a  user  number 
or  the  user  must  select  a  user  number  previously  entered.  If  the 
user  elects  to  enter  a  new  identification,  the  number  of  the 
document  desired  must  be  chosen  from  a  list  of  current  products . 
The  list  of  current  products  is  printed  from  the  DOCFILE  file. 

User  information  exists  in  the  USERS  file.  A  new  user 
identication  is  written  to  that  file. 

If  the  user  does  not  choose  to  enter  a  new  identification,  a 
list  of  users  from  the  USERS  file  is  displayed  at  the  terminal . 

In  thus  choosing  a  previously  entered  user  number,  the  current 
user  is  also  implicitly  choosing  a  product. 

This  product,  associated  with  the  user  and  a  product  ID 
number,  controls  transfer  to  a  specific  TSK  file — TSKnn,  where  nn 
is  the  product  number.  Transfer  is  made  to  the  record  in  TSKnn 
containing  information  for  the  first  task  in  the  product's  first 
area. 

AUTO  next  presents  the  user  with  the  opportunity  to  "run 
functional  tasks."  A  listing  of  product  areas  is  displayed,  and 
the  user  must  select  one  area. 

A  search  is  made  in  TSKnn  until  the  selected  area  is  found. 
Task  titles  for  that  area  are  read  frcm  the  STRnn  file  and  listed 
by  number  and  title  at  the  terminal. 

The  user  may  then  choose  to  "accomplish  a  task"  in  the 
selected  area  by  entering  a  task  number. 


A  ft- 
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AUTO  next  searches  the  INDnn  file  for  the  first  record 
containing  information  for  the  chosen  task.  The  first  such 
record  always  points  to  a  question  in  the  STRnn  file.  That 
question  is  displayed  at  the  terminal  as  "QUESTION  #  1 . " 

The  user's  response  to  the  question  may  be  "Y"  (yes),  "N" 
(no),  or  "U"  (undecided).  The  response  initiates  a  sequence  of 
information  retrievals  which  is  controlled  by  chaining  pointers 
in  the  INDnn  file. 

The  information  retrieved  is  displayed  on  the  screen  and 
saved  in  the  SCRnnn  file  in  preparation  for  the  printout  of  the 
product.  Such  information  can  be  cxie  or  more  of  the  following: 
essential  entries;  action  messages;  document  headers;  document 
parts;  task  OPR  information. 

AUTO  retrieves  essential  entries  and  action  messages  from  the 
STRnn  file;  document  headers  and  task  OPR  information  from  the 
HEADERS  file;  document  parts  from  the  STDFILE. 

After  response  to  the  first  question  is  complete,  the  user 
may  continue  to  retrieve  cind  einswer  the  remaining  task  questions, 
if  there  are  any.  When  the  task  is  ccanplete,  the  user  has  these 
choices :  to  return  to  the  task  menu  and  choose  another  task  to 
accomplish;  to  quit  with  no  printout  or  word  processor  file;  to 
exit  with  1-9  printouts  (as  user  specifies)  and/or  a  word 
processor  file  of  accomplished  tasks.  Word  processor  files  are 
files  intended  to  be  transferred  to  word  processors. 


42 


4.3  SYSSUB 

The  file  SYSSUB  contains  subroutines  and  a  single  function 
required  by  both  the  CREATE  and  AUTO  programs. 

The  subroutines  are: 

ASK 

CONTIN 

HDR_70 

PRT_STR 

RDjrSK 

WRT_STR 

The  function  is; 

NUMjOON 

4.4  CRESUB 

The  file  CRESUB  contains  subroutines  and  a  single  function 
required  by  the  CREATE  program. 

The  subroutines  are; 


ADD_STR 
ADD-HDR 
PRT__FND 
QUS_MOD 
QUSJWRT 
STD_FND 
QUS  RES 


The  function  is 


FLT_OON 
4.5  AUTSUB 

The  file  AUTSUB  contains 
AUTO. 

The  subroutines  are: 

ANSjGET 
ANS_PUT 
ESSJWRT 
ACT_WRT 
QUS__RUN 
STD_APP 
STDJWRT 
STD_INS 
STDJTSK 
PRT  INS 
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required  by  the  program 


